home *** CD-ROM | disk | FTP | other *** search
/ Maclife 157 / MACLIFE157-2001-09.ISO.7z / MACLIFE157-2001-09.ISO / Linux / MacOS Tools / MacGzip / README < prev   
Text File  |  2001-07-23  |  12KB  |  229 lines

  1. ・  MacGzip 1.1.3 (gzip 1.2.4)
  2.  
  3.    MacGzip is Jean-loup Gailly's gzip compressor (GNU zip) for the Macintosh, ported to Mac by SPDsoft. (If you have any comment about MacGzip, please send it to me <macspd@ivo.cps.unizar.es>, not to Jean-loup Gailly.)
  4.  
  5.     MacGzip requires system 7 or better, and it should work in any Macintosh if you have the correct combination of software and CPU (if you want to know which version of MacGzip you have, choose 'get info' from the finder;  68K and FAT run on any Macintosh (FAT runs native for Power Macs); and the version for Power Mac only runs on Power Macs)
  6.  
  7.     MacGzip works better if you have Internet Config installed;
  8.  
  9.     gzip is not an archiver, but a compressor. A compressor makes a compressed file for every plain file; an archiver will make a single compressed file from a set of files/directories. Maybe some day I will try to port GNU tar (the natural archiver to be used with gzip) to Macintosh, but don't rely on this...
  10.     
  11.     You should read the files in 'GNU docs' folderノ
  12.  
  13. ・ Configuring MacGzip
  14.  
  15.     The easiest way to use MacGzip is as a Drag & Drop tool; depending on what you enter in the preferences dialog, the use can be fully automatic or manual.
  16.  
  17.     Note: 'Drag&Drop keys' are the keys you push while dragging a files/folders on MacGzip. You should hold them down until the window (for the first file) appears.
  18.  
  19.  - gzip standard options:
  20.  
  21.     * gzip suffix:
  22.  
  23. This is the '-s' option of standard gzip. Here you can specify an optional suffix to use instead of '.gz'. If you are using the standard suffixes; don't check this option.
  24.  
  25. If you have to expand files with a suffix different of ".gz", ".z", ".Z", ".taz", ".tgz", "-gz", "-z" and "_z" often, (for instance, one member .zip files); you should check the 'only when decompressing' option as well.
  26.  
  27. Note: Setting custom suffix to '.Z' won't force MacGzip to create Unix 'compress' files; but gzip files with .Z suffix, which can be confusing.
  28.  
  29.     * Compression level:
  30.  
  31. This is the '-[1-9]' option. The higher level, the slower and better compression. Compression level does not affect to decompression.
  32.  
  33.     * Force overwrite:
  34.  
  35. This is the '-f' option. If you set it, MacGzip will overwrite files or empty folders if their names are the same of an output file.
  36.  
  37.     * Always save/restore name & date:
  38.  
  39. This is the '-N' option:
  40. When compressing, always save the  original  file  name and  time  stamp; this is the default. When decompressing, restore the original file name and time  stamp  if present.  This option is useful on systems which have a limit on file name length or when the  time  stamp  has been lost after a file transfer.
  41.  
  42. Note:
  43.  
  44.     - If the original name contains illegal characters, MacGzip will replace them regardless if you check this option or not.
  45.  
  46.     * Never save/restore name & date:
  47.  
  48. This is the '-n' option:
  49. When compressing, do not save the  original  file  name and time stamp by default. (The original name is always saved  if  the  name  had  to   be   truncated.)   When decompressing, do not restore the original file name if present  (remove  only  the  gzip   suffix   from   the compressed  file  name) and do not restore the original time stamp if present  (copy  it  from  the  compressed file). This option is the default when decompressing.
  50.  
  51.     * Drop folder options: 
  52.  
  53. -r option. You can drop folders on MacGzip; but in this version, you can't have more than 512 files in the queue.
  54.  
  55.   - MacGzip options:
  56.  
  57.  
  58. You can use MacGzip as a pure Unix gzip or as a Macintosh compressor.
  59.  
  60. In the first case, you may turn off all the MacBinary options (for compress and decompress preferences); but anyway you should use some suffix mapping to treat text files in a proper way. (well, if you always use binary mode, you always can use an end-of-line converter; but it
  61. will take you more time...).
  62.  
  63. If you know you will never transfer a .gz file to any non-MacOS machine; you can use always MacBinary. (anyway, there are also MacBinary translators for other machines; in unix you can use 'capit', from Columbia AppleTalk Package)
  64.  
  65. Please, read the document 'File formats' for more info.
  66.  
  67. The default settings will try to use Internet Config to decide when to use one format or other. Default settings for Internet Config map many suffixes of files in which only the data fork is relevant to 'Macintosh file', just to make sure you don't loose things like Finder custom icons and things like that.
  68.  
  69. If you are planning to transfer gzip files to another OS, and you want to use IC, make sure you set all the mappings properly.
  70.  
  71. In decompression preferences, it is safe to check the 'Always try MacBinary'. (but can be a little slower). MacGzip checks the MacBinary II+ crc for the first 128 bytes of the file, so it will use MacBinary only for actual MacBinary gziped files.
  72. (In the progress window, you may notice that for short files the string mode is always 'MBII' even for binary or ascii files; this is because the input file was so short so MacGzip can't know which mode to use till it have read the entire file; anyway the correct mode is used)
  73.  
  74. Note: MacGzip MacBinary mode doesn't save/restore Finder comments. (people uses them, anyway?)
  75.  
  76. The mode (and the compress/decompress) selection is made according your preferences:
  77. First Drag&Drop keys -if you checked this option- or menu selection; then automatic selections, and as last resource, the default mode (operation).
  78.  
  79. Note: If you want to use Fetch prefs for suffix mapping, make sure you check the corresponding option in MacGzip decompress preferences (it is not the default for MacGzip 1.1). (Fetch 3.0 uses IC, too).
  80.  
  81. The 'use ASCII for TEXT files' option is safe unless you have some wicked programs which make binary files with 'TEXT' signature. (like some communications software). Anyway IC should be enaugh to handle this...
  82.  
  83. The 'Beep when done' preference has a side effect. If it is checked, an audible 'click' will let you know MacGzip has accepted the file(s) you drop on it (and so you can release the modifier keys...)
  84.  
  85.     * Signatures:
  86.  
  87. Files compressed with gzip haven't any information about the kind of document of the original file; so to decompress them MacGzip has to guess it. Sometimes this can be done by looking at the suffix; when this fails, it will use these.
  88.  
  89. You can find more information about this in the 'Suffix Mapping' document.
  90.  
  91.     * More Help:
  92.  
  93. In the preferences dialog there is a little check box with a tiny balloon icon. Check this to see what every item on the dialog means.
  94.  
  95. You can read the rest of the documentation to find out about file types, transmision modes, suffix mapping, the meaning of life and even more.
  96.  
  97.  
  98. ・ Using Macgzip
  99.  
  100.     Select your files/folders and drop them on the MacGzip icon.
  101.  
  102.     The 'cancel' button (or cmd-period) interrupts the process and the partial output file is erased.
  103.  
  104.     If you want to cancel all pending work, select 'Quit' (or cmd-Q) in File menu. (this is a safe exit, you should never force exit using cmd-opt-esc except as a last resort)
  105.  
  106.     Once MacGzip is working on a file, you can't use the File menus to submit new work;
  107. but you can drop files/folders from the Finder onto the MacGzip icon or use the Standard Apple Events.
  108.  
  109.     These are the modifier keys you can use:
  110.  
  111.         a:      Force ASCII (text) mode
  112.         b:      Force Binary (raw) mode
  113.         m:      Force MacBinary mode
  114.         opt:    Force compression
  115.         shift:  Force decompression
  116.         ctrl:   Force 'Prompt for destination' (useful for Read Only media)
  117.  
  118.     (You don't need to remember this, you can read it at any time in the MacGzip Finder Help Balloon)
  119.  
  120.  
  121. ・ About types & creators
  122.  
  123.     I have used the following file Types:
  124.  
  125.        suffix   type    creator
  126.         .gz      Gzip     Gzip  gziped
  127.         .Z       ZIVU     Gzip  compressed (from maccompress)
  128.         .z       pZIP     Gzip  pkziped    (from UnZip 2.0.1)
  129.  
  130.     Anyway, read GNUユs gzip.doc to find out about formats.
  131.  
  132.     When you download a file from a non-mac host, the program that you are using to download must assign it two flags: File Type and File Creator.  These are two four character words that the Mac uses to know what icon they must have, what application must be opened when you make a double click on it, and if a 'open file' dialog should show the file or not.
  133.  
  134.     So, you should use a downloading application with a "suffix mapping" menu or preference, or at least, a drag&drop file typer.  With this version of MacGzip, you don't need to use the correct type, but is a good idea to keep your files well typed.
  135.  
  136.  
  137.     If you want MacGzip to set the correct types but you don't use Fetch, you can find a 'Fetch Prefs' file in the 'Suffix Mapping'. You can copy it to your Preferences folder (in your System folder); and if you want to add suffixes, you can edit it with ResEdit or other resource editor (there is a template included).
  138.  
  139.     Or you can use Internet Config, available from
  140.       ftp://redback.cs.uwa.edu.au//Others/PeterLewis/
  141.       ftp://ftp.nig.ac.jp/pub/mac/PeterLewis/
  142.       ftp://nic.switch.ch/software/mac/peterlewis/
  143.       ftp://amug.org/pub/peterlewis/
  144.       ftp://ftp.share.com/peterlewis/
  145.       ftp://cadadmin.cadlab.vt.edu/peterlewis/
  146.       ftp://ftp.acns.nwu.edu/pub/newswatcher/helpers/
  147.       ftp://ftp.tidbits.com/pub/tidbits/
  148.  
  149.  
  150.  
  151. ・ Warranty & so
  152.  
  153.     The guarantee is directly proportional to the price of the application: NONE. (OK, if you loose a very important file with 2.3 Mb of data, let me know it and I  will send you a few words of condolence).
  154.  
  155. ・ Year 2000 Compilance
  156.  
  157.     MacGzip is as Y2K compilant as MacOS. (well, in fact, dates in .gz files are stored in unix 32 bit wide format, this mean tinks can go wrong beyond 2038, see <URL:http://www.gnu.org/software/year2000.html>)
  158.  
  159.     MacGzip was Y2K tested by the simple procedure of making it work on a Macintosh with date manually set to beyond year 2000, and everything was OK.
  160.  
  161.  
  162. ・ Thanks to:
  163.  
  164.  Jean-loup Gailly <jloup@chorus.fr> for gzip
  165.  Erling Johansen <ejo@vingmed.no> for the port to PPC and Posix lib used in 03bx
  166.  Timothy Murphy <tim@maths.tcd.ie> for Posix lib used in the first versions.
  167.  Quinn "The Eskimo" <quinn@cs.uwa.edu.au> and
  168.  Peter N Lewis <peter.lewis@info.curtin.edu.au> for Internet Config Prog. Kit
  169.  Peter N Lewis (again) for MacBinary II+ stuff
  170.  Todd Clements (tclement@hmc.edu) for DialogControls code
  171.  Steve Falkenburg -- MacDTS for CustomGetFolder
  172.  tree@uvm.edu for SpinCursors code
  173.  Greg Robbins for Prefs code
  174.  C.K. Haun (Apple DTS) for Movable Modal code
  175.  Color Alysoft Solutions <heathcot@bnr.ca> for Color Progress bar code
  176.  Bryan Stearns (Apple DTS) for Pop Up  Menus code
  177.  Dave Rubinic for Easy Errors 1.0 resources
  178.  Jesse Carneiro (jcarneur@freenet.columbus.oh.us) for click sound
  179.  Luke Collie <colliel@siva.bris.ac.uk> for helping with documentation
  180.  Lloyd Chambers (MacCompress) for Icons idea
  181.  David "ELEE74L" Alten <"elee74l@menudo.uh.edu"> for icons improvement
  182.  All other people whose source code I used ヤfor documentationユ 
  183.  And people who sent bug reports
  184.  
  185.  At last, thanks to myself
  186.     macspd@ivo.cps.unizar.es
  187.     spd@daphne.cps.unizar.es
  188.  for being such nice company.
  189.  
  190.  Latest about MacGzip:
  191.     http://persephone.cps.unizar.es/~spd/gzip/
  192.  
  193.  
  194. ・ REWARD 0.000.000 $
  195.   BUGS (dead or alive)
  196.  
  197. A m’ me gusta dormir
  198. hasta el medio d誕 y
  199. aullar a la luna
  200. y a las estrellas y...
  201.  
  202. ...Y entrar y salir
  203. de mi chabolo sin
  204. ninguna explicaci溶 que dar
  205. S’, a m’ me gusta asi.
  206.  
  207. Claro que algunas noches
  208. no puedo dormir
  209. Entonces me ducho
  210. y si quema mucho
  211.  
  212. me da el arrechucho
  213. y salgo a por t’.
  214.  
  215. Y... タQuŽ mas me gusta a m’?
  216. チAh, s’! la pintura y...
  217. Y m‡s si es de labios,
  218. Si, a m’ me gusta as’
  219. タY quŽ era lo otro? チAh, s’!
  220. Lo que m‡s me gusta a m’
  221. ...タTe lo digo en casa
  222. o te lo digo aqu’?
  223.  
  224.  
  225.     mejor
  226.     Los Enemigos
  227.  
  228.  
  229.